home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu062.dms / pu062.adf / HAMedit10.doc < prev    next >
Text File  |  1987-06-06  |  10KB  |  157 lines
  1. _____________________________________________________________________
  2.                                                                      \
  3. HamEdit10                                                             |
  4. Written by James Carpino of Resolution Computer Research (RCR).       |
  5. I am placing this program in the public domain.                       |
  6. This program may be copied in its                                     |
  7. entirety and distributed, and may not                                 |
  8. be used or sold for commercial use.                                   |
  9. Resolution Computer Research is currently a small non-profit          |
  10. software development company devoted to the development of            |
  11. software and hardware for the Commodore 64/128 and Amiga PCs.         |
  12. WE ARE NOT RICH so if you find any RCR programs useful                |
  13. please feel free to send a donation of $2 or more to:                 |
  14. ---------------------------------\                                    |
  15. James Carpino                     |                                   |
  16. Resolution Computer Research      |                                   |
  17. 86-08 106th street Richmond Hill  |                                   |
  18. New York, NY 11418                |                                   |
  19. ---------------------------------/                                    |
  20. We are also currently working on:                                     |
  21. HAM (Hold-And-Modify) Image Editor: This is this program. Enjoy it.   |
  22.  We're always improving it and updating it.                           |
  23. HAM library for C language, to use HAM in your own software.          |
  24.  Theese routines are used in HAM Image Editor.                        |
  25. Emily-64: a 6502 microprocessor emulator to enable the Amiga          |
  26.  to eventually run Apple II, Commodore 64, and Atari 800XE            |
  27.  software.  This will hopefully run at full speed, but we NEED        |
  28.  a developer's kit or Manx C compiler/assembler donation TO           |
  29.  accomplish this.                                                     |
  30. Dimension-Three: AmigaBasic program to plot three-dimensional         |
  31.  formulas on any resolution screen (including interlaced).            |
  32. EditWave: AmigaBasic program to edit 256-byte waveforms with          |
  33.  sine, square, triangle, etc. waveforms and mixing.                   |
  34. _____________________________________________________________________/
  35.                                                                      \
  36. Any donations will be recorded with the donor's name                  |
  37. and put towards our development needs.  If, at any point,             |
  38. we succeed in developing products worthy of sale for a profit,        |
  39. any donations will be returned at the rate of twice the donated       |
  40. value.  Until we are on our feet (business-wise) we can make          |
  41. no promises as to the return of donated funds, equipment, etc.        |
  42. _____________________________________________________________________/
  43.                                                                      \
  44. The Instructions:                                                     *
  45.  
  46. How to use HamEdit10:
  47. Call the program from AmigaDos, using the following paramaters:
  48.    HamEdit10 -h[height] -w[width] -i
  49. Leaving out the -h and -w paramaters will cause HamEdit10 to default to
  50. the 320*200 screen format.  Any height over 232 will be made interlaced.
  51. Using the -h option with no parameter will cause height to default to 400.
  52. Some examples:
  53.    HamEdit10 -h233          ;Creates a HAM screen 320 by 233 interlaced.
  54.    HamEdit10 -w352 -h       ;Creates a HAM screen 352 by 400 interlaced.
  55.    HamEdit10 -h100 -w100 -i ;Creates a HAM screen 100 by 100 interlaced.
  56.    HamEdit10 -h230      ;Creates a HAM screen 320 by 230 non-interlaced.
  57.    HamEdit10 -w336 -h156 -i ;Creates a HAM screen 336 by 156 interlaced.
  58.    HamEdit10 -i             ;Creates a HAM screen 320 by 200 interlaced.
  59. It is important to remember that the Amiga hardware can do low-resolution
  60. screens up to 368 dots in width, and high-resolution screens up to 736 in
  61. width.  Under Kickstart 1.1, though, these screens will not work properly
  62. unless perfectly centered by Preferences (the screen position slider), and
  63. screens over 352 (704 hires) will not work at all, regardless of the slider.
  64. Under Kickstart 1.2, the screen will work properly regardless of the
  65. position of the Preferences screen slider, though you may not see all of
  66. it.  As for height, non-interlaced screens may go up to 236 in height and
  67. interlaced screens may go up to 472 in height.  Again, if the screen is not
  68. positioned correctly, it may not work properly under Kickstart 1.1.  If the
  69. screen is above 200 or 400 interlaced, 1.1 will not show that part which
  70. streches over the limit.  The only way to remedy this in 1.1 is to go to the
  71. top of the screen, and drag the screen drag bar upwards until all the screen
  72. is visible.  The screen will not move, but the bottom border will, and the
  73. mouse pointer will point to a position several dots lower.  In Kickstart
  74. 1.2, the entire screen will automatically be visible (provided the
  75. Preferences screen position gadget is in the upper left corner), but the
  76. pointer will not reach below the 200 (or 400 interlaced) limit.
  77.    "Wait a minute-  did he say ALL?  Uh- I can't see all of it, my 368 by
  78. 472 screen goes off the screen no matter what I do!" says a fairly well-
  79. educated experimenter, who is sure he has the preferences slider all the
  80. way to the upper left.  He has a problem: His monitor will not physically
  81. display a screen much larger than 320 (or 640 hi-res)  by 200 (or 400
  82. interlaced).  This is true of all the current Commodore monitors and most
  83. color monitors.  They do something called overscanning. This is so the
  84. scanning gun in the CRT (Cathode Ray Tube) has time to get from the right of
  85. the screen to the left of the screen, and from the top to the bottom.  It is
  86. different on most monitors (TV's, composite, RGB, etc.) so the Amiga uses
  87. the position gadget in Preferences to make sure most of the screen is
  88. visible.  If you have a monochrome monitor, or an old-fashioned color TV
  89. with all the controls, you can change the Horizontal and Vertical size;
  90. usually the smallest settings will allow for most of a 368 by 472 screen to
  91. be displayed.  Some expensive RGB monitors will display the larger screens,
  92. too; and if you have an expensive high-persistence phosphor monitor which
  93. displays the full 368 by 472 screen, you're rich and you should have bought
  94. a XEROX mainframe with a few graphics terminals.
  95.    Now, back to our little graphics editor.  The commands are summarized as
  96. follows:
  97.    d  --Goes to draw mode (full lines), just like in DeluxePaint.
  98.    s  --Goes into spots mode (dotted lines), just like DeluxePaint.
  99.    , (comma key) --Picks a color from anywhere on the screen, not including
  100.       the palette; this is similar to DeluxePaint, but the color is chosen
  101.       immediately.  This can be held down to roll through colors on screen.
  102.    . (period key) --Changes the brush size to 3*3, similar to DeluxePaint.
  103.    - (minus key) Reduces the X and Y size of the brush. (DeluxePaint)
  104.    = (Equals key, look at the plus sign) Increases the width of the brush.
  105.    \ (Backslash key, next to the = key) Increases the height of the brush.
  106.    HELP --Redraws all the information and fixes brush size, color, and
  107.       drawing mode to default; also pops back menu bar and windows to
  108.       original positions.
  109.    F10 --Pops in and out the MENU bar, to allow for the full screen height.
  110.    [ and ] --Change the current color to one of the 16 colors; these are
  111.       fast and are not HAM colors. (These keys also work in DeluxePaint)
  112.    8-9,5-6,2-3: Up and down for HAM red, green, and blue, respectively.
  113.       The current HAM color is also displayed as standard color #8. (These
  114.       keys also work in DeluxePaint)
  115.    Del --(above the BackSpace key)  Clears the screen and does HELP.
  116.    ESC --The beloved escape key- Exits the program, relieving you of the
  117.       terrible wrath of drawdom.
  118.  
  119.    The Color and Info windows can be moved anywhere you like, but currently
  120. they cannot be popped away.
  121.    If you click or move either of the Color or Info windows, the first click
  122. you make in the drawing screen will not draw; this is so you do not goof up
  123. a picture just for the sake of selecting the correct window.  The Info&Color
  124. windows will tell you in the title bar when they are selected to remind you
  125. of this.
  126.    The Info window has the pen position in its title bar, and within the
  127. window are listed the pen width and height, color, and red, green, and blue
  128. elements of the current pen color.
  129.    Clicking within the color window chooses any of the colors displayed
  130. within the color window, including the bottom 16 colors.  Color #8 will
  131. always turn to the current color, so there's no purpose to using #8.
  132. The current color number will also appear in the info window.  The size of
  133. the color window depends on the size of the screen; when the screen size
  134. is shorter than 300, not all the colors will be displayed.
  135.    Remember to fix Preferences to 80 columns, HamEdit10 currently does not
  136. open its own font; this saves memory and time.
  137.    If your screen will be larger than normal, remember to move the screen
  138. slider in Preferences to the upper left.
  139.    The penwidth can be no less than 3 dots wide because it takes 3 dots to
  140. makea HAM color: 1 for red, 1 for green, and 1 for blue.  If you have to
  141. increase the size of the brush drastically, increase the height; height is
  142. drawn faster than width.  You can, however, draw with a brush 1 dot wide if
  143. you are using one of the bottom 16 colors.
  144.    If there is anything I've forgotten, you'll notice it before long.
  145. HamEdit still does not save, load, undo, and all those lovely features that
  146. normal painting programs have.  HamEdit is still being worked on, and all
  147. those features will be added in the future.  First priority are load/save
  148. and shading, before anything else; one of these two features will appear in
  149. HamEdit11.  If you find any bugs or awkwardnesses (besides the awkward word
  150. awkwardnesses) please tell me about them.  We sometimes forget to fix even
  151. the bugs we know about.
  152.  
  153.                                              Sincerely,
  154.                                              James Carpino, Programmer
  155.                                              Resolution Computer Research
  156.  
  157.